<!doctype HTML public "-//W3C//DTD HTML 4.0 Transitional//EN">
<!-- Click to Convert 5.2: Anything to HTML -->
<!-- http://www.clicktoconvert.com -->

<html>
<head>
<title>gravityboxscheduleuserguide - page 18 of 234</title>
<meta http-equiv=content-type content=text/html;charset=iso-8859-1>
<meta name="Generator" content="Click to Convert">

<!--Start of page styles-->
<STYLE TYPE="text/css">
<!--
 /* Foreground Image Styles */

 /* Position Styles */
 .ts18p0{position:absolute;left:106px;top:97px;}
 .ts18p1{position:absolute;left:352px;top:97px;}
 .ts18p3{position:absolute;left:672px;top:97px;}
 .ts18p7{position:absolute;left:106px;top:113px;}
 .ts18p8{position:absolute;left:706px;top:1026px;}
 .ts18p9{position:absolute;left:331px;top:1044px;}
 .ts18p13{position:absolute;left:161px;top:146px;}
 .ts18p15{position:absolute;left:295px;top:146px;}
 .ts18p16{position:absolute;left:295px;top:164px;}
 .ts18p17{position:absolute;left:295px;top:183px;}
 .ts18p18{position:absolute;left:295px;top:201px;}
 .ts18p20{position:absolute;left:161px;top:223px;}
 .ts18p22{position:absolute;left:295px;top:223px;}
 .ts18p24{position:absolute;left:295px;top:241px;}
 .ts18p25{position:absolute;left:295px;top:259px;}
 .ts18p27{position:absolute;left:161px;top:281px;}
 .ts18p29{position:absolute;left:295px;top:281px;}
 .ts18p30{position:absolute;left:295px;top:299px;}
 .ts18p31{position:absolute;left:295px;top:318px;}
 .ts18p33{position:absolute;left:295px;top:336px;}
 .ts18p35{position:absolute;left:161px;top:357px;}
 .ts18p37{position:absolute;left:295px;top:357px;}
 .ts18p38{position:absolute;left:295px;top:376px;}
 .ts18p39{position:absolute;left:295px;top:394px;}
 .ts18p41{position:absolute;left:161px;top:416px;}
 .ts18p43{position:absolute;left:295px;top:416px;}
 .ts18p45{position:absolute;left:295px;top:434px;}
 .ts18p46{position:absolute;left:295px;top:452px;}
 .ts18p48{position:absolute;left:161px;top:474px;}
 .ts18p50{position:absolute;left:295px;top:474px;}
 .ts18p51{position:absolute;left:295px;top:492px;}
 .ts18p53{position:absolute;left:295px;top:511px;}
 .ts18p54{position:absolute;left:295px;top:529px;}
 .ts18p55{position:absolute;left:295px;top:547px;}
 .ts18p57{position:absolute;left:161px;top:569px;}
 .ts18p59{position:absolute;left:295px;top:569px;}
 .ts18p65{position:absolute;left:295px;top:587px;}
 .ts18p66{position:absolute;left:295px;top:606px;}
 .ts18p67{position:absolute;left:295px;top:624px;}
 .ts18p68{position:absolute;left:295px;top:642px;}
 .ts18p69{position:absolute;left:295px;top:661px;}
 .ts18p71{position:absolute;left:295px;top:679px;}
 .ts18p72{position:absolute;left:295px;top:698px;}
 .ts18p73{position:absolute;left:295px;top:716px;}
 .ts18p74{position:absolute;left:295px;top:734px;}
 .ts18p76{position:absolute;left:106px;top:753px;}
 .ts18p77{position:absolute;left:106px;top:771px;}
 .ts18p78{position:absolute;left:106px;top:790px;}
 .ts18p79{position:absolute;left:106px;top:808px;}
 .ts18p83{position:absolute;left:106px;top:826px;}
 .ts18p84{position:absolute;left:106px;top:845px;}
 .ts18p86{position:absolute;left:106px;top:863px;}
 .ts18p87{position:absolute;left:106px;top:882px;}
 .ts18p88{position:absolute;left:106px;top:900px;}
 .ts18p90{position:absolute;left:106px;top:918px;}
 .ts18p91{position:absolute;left:106px;top:937px;}
 .ts18p92{position:absolute;left:106px;top:955px;}
 .ts18p94{position:absolute;left:106px;top:974px;}

 /* Font Styles */
 .ft0p18{font-style:normal;font-weight:bold;font-size:13px;font-family:arial,sans-serif;color:#000000;}
 .ft1p18{font-weight:normal;}
 .ft2p18{font-style:normal;font-weight:normal;font-size:13px;font-family:"times new roman","times new roman",times,serif;color:#000000;}
 .ft3p18{font-style:normal;font-weight:normal;font-size:16px;font-family:"times new roman","times new roman",times,serif;color:#000000;}
 .ft4p18{font-style:normal;font-weight:bold;font-size:11px;font-family:arial,sans-serif;color:#000000;}
 .ft5p18{font-style:normal;font-weight:normal;font-size:16px;font-family:arial,sans-serif;color:#000000;}

 /* Background Style */
 .styleBackground18{position:absolute;left:105px;top:145px}

 /* Navigation Styles */
 .styleNavBarTop{position:absolute;left:0px;top:2px}
 .nb{position:absolute;left:2px;top:0px}
 .nbs{position:absolute;left:0px;top:0px}
 .nbe{position:absolute;left:836px;top:0px}
 .styleNavBarBot{position:absolute;left:0px;top:1117px}
-->
</STYLE>
<!--End of page styles-->

</head>
<body bgcolor="#ffffff" text="#000000" link="#0000FF" Vlink="#660099">

<table id="pageTable" width="836" STYLE="position: relative; left: auto; top: auto;"><tr><td>
<div class=nbs><img src="./navbarstart.gif" width="2" height="30"></div>
<div class=nb><img src="./navbar.gif" width="836" height="30" alt="Navigation bar"></div>
<div class=nbe><img src="./navbarend.gif" width="2" height="30"></div>
<div class=styleNavBarTop>
<table width="834" height="26" border="0" cellspacing="0">
  <tr align="left">
    <td width="4">&nbsp;</td>
    <td width="25" align="center"><a href="http://www.gravitybox.com" target="_parent"><img src="./home.gif" border="0" alt="Home"></a></td>
    <td width="25" align="center"><a href="#" onClick="window.open('./print.html','Printing','width=300,height=100,toolbar=no,directories=no');return false;"><img src="./print.gif" border="0" alt="Print document"></a></td>
    <td width="10" align="center"><img src="./separator.gif" border="0"></td>
    <td width="18" align="center"><a href="./index1.html"><img src="./start.gif" width="18" height="14" border="0" alt="Start"></a></td>
    <td width="18" align="center"><a href="./index17.html"><img src="./back.gif" width="14" height="14" border="0" alt="Previous page"></a></td>
    <td width="80" valign="middle"><table width="100%" height="16" border="0" cellspacing="1" bgcolor="#ACA899"><tr><td align="center" bgcolor="#ffffff"><font face=verdana,arial,sans-serif><font size="1">&nbsp;18 of 234&nbsp;</font></font></td></tr></table></td>
    <td width="18" align="center"><a href="./index19.html"><img src="./forward.gif" width="14" height="14" border="0" alt="Next page"></a></td>
    <td width="18" align="center"><a href="./index234.html"><img src="./end.gif" width="18" height="14" border="0" alt="End"></a></td>
    <td width="620">&nbsp;</td>
  </tr>
</table>
<p>
</div>
<nobr>
<div class=styleBackground18><img src="./background18.png" width="632" height="910" border="0" alt=""></div>
<div class=ts18p0><span class="ft0p18"> </span></div>
<div class=ts18p1><span class="ft0p18">Gravitybox Schedule Primer<span class="ft1p18"> </span></span></div>
<div class=ts18p3><span class="ft0p18">Page 16&nbsp; </span></div>
<div class=ts18p7><span class="ft2p18"> </span></div>
<div class=ts18p8><span class="ft3p18"> </span></div>
<div class=ts18p9><span class="ft4p18">1998&#45;2004 Gravitybox Software LLC<span class="ft3p18"> </span></span></div>
<div class=ts18p13><span class="ft5p18">Room </span></div>
<div class=ts18p15><span class="ft5p18">When the schedule is setup to display Rooms, only </span></div>
<div class=ts18p16><span class="ft5p18">appointments with a valid Room property will be displayed. </span></div>
<div class=ts18p17><span class="ft5p18">When the schedule is not displaying Rooms, this property is </span></div>
<div class=ts18p18><span class="ft5p18">not used. </span></div>
<div class=ts18p20><span class="ft5p18">StartDate </span></div>
<div class=ts18p22><span class="ft5p18">This property is the date on which the appointment will be </span></div>
<div class=ts18p24><span class="ft5p18">displayed. The valid date range is the MinDate property to </span></div>
<div class=ts18p25><span class="ft5p18">the MaxDate property. </span></div>
<div class=ts18p27><span class="ft5p18">StartTime </span></div>
<div class=ts18p29><span class="ft5p18">This property defines the time an appointment is to start. </span></div>
<div class=ts18p30><span class="ft5p18">Used in conjunction with the StartDate property, it determines </span></div>
<div class=ts18p31><span class="ft5p18">the position of the appointment on the schedule. If the </span></div>
<div class=ts18p33><span class="ft5p18">appointment is an event, this property has no genuine value. </span></div>
<div class=ts18p35><span class="ft5p18">Subject </span></div>
<div class=ts18p37><span class="ft5p18">This is text that may be used to identify an appointment. </span></div>
<div class=ts18p38><span class="ft5p18">Either the DisplayText or Subject may be used as the text </span></div>
<div class=ts18p39><span class="ft5p18">displayed on the schedule. </span></div>
<div class=ts18p41><span class="ft5p18">Tag </span></div>
<div class=ts18p43><span class="ft5p18">This is an extra string value that may be used to save some </span></div>
<div class=ts18p45><span class="ft5p18">additional information associated with this appointment </span></div>
<div class=ts18p46><span class="ft5p18">object. It is not used by the schedule for any purpose. </span></div>
<div class=ts18p48><span class="ft5p18">ToolTipText </span></div>
<div class=ts18p50><span class="ft5p18">This text is used to display a tooltip over an appointment </span></div>
<div class=ts18p51><span class="ft5p18">when the mouse is at rest over it. This is the default value for </span></div>
<div class=ts18p53><span class="ft5p18">the appointment&#146;s tooltip. If this property is not specified, it&#146;s </span></div>
<div class=ts18p54><span class="ft5p18">DisplayText or Subject property is used, depending on the </span></div>
<div class=ts18p55><span class="ft5p18">schedule&#146;s ToolTipDisplay property. </span></div>
<div class=ts18p57><span class="ft5p18">UniqueKey </span></div>
<div class=ts18p59><span class="ft5p18">This read&#45;only property is a unique 32&#45;bit integer that </span></div>
<div class=ts18p65><span class="ft5p18">identifies this appointment from all the rest in the </span></div>
<div class=ts18p66><span class="ft5p18">ScheduleItems collection. When an appointment is added, a </span></div>
<div class=ts18p67><span class="ft5p18">unique key is generated and assigned to this property. It may </span></div>
<div class=ts18p68><span class="ft5p18">not be changed and will be different on every load. However, </span></div>
<div class=ts18p69><span class="ft5p18">the most important thing is that it never changes as long as </span></div>
<div class=ts18p71><span class="ft5p18">the schedule is loaded. Even if dragged to another window, </span></div>
<div class=ts18p72><span class="ft5p18">the appointment&#146;s UniqueKey will not change. It is provided </span></div>
<div class=ts18p73><span class="ft5p18">to give the developer a way to uniquely identify an </span></div>
<div class=ts18p74><span class="ft5p18">appointment in a schedule session. </span></div>
<div class=ts18p76><span class="ft5p18"> </span></div>
<div class=ts18p77><span class="ft5p18">A change in many of these properties will result in a display change of the appointment </span></div>
<div class=ts18p78><span class="ft5p18">or the schedule. Some other properties of an appointment, though still important, are </span></div>
<div class=ts18p79><span class="ft5p18">not display related. A change in non&#45;display properties will not result in a repaint of the </span></div>
<div class=ts18p83><span class="ft5p18">appointment or screen. They represent associated data that may be saved with an </span></div>
<div class=ts18p84><span class="ft5p18">appointment. An example of this is the Id or ItemData property. </span></div>
<div class=ts18p86><span class="ft5p18"> </span></div>
<div class=ts18p87><span class="ft5p18">Some of the more interesting properties include Alarm, BlackOut, MinLength, and </span></div>
<div class=ts18p88><span class="ft5p18">MaxLength. The Alarm property allows for the creation of applications that raise an </span></div>
<div class=ts18p90><span class="ft5p18">event, at the start of an appointment. The ScheduleItemStart event is raised to inform of </span></div>
<div class=ts18p91><span class="ft5p18">this happening. The index of the object in the ScheduleItems collection is returned, as a </span></div>
<div class=ts18p92><span class="ft5p18">parameter to this event. The following code display a message box at each </span></div>
<div class=ts18p94><span class="ft5p18">appointment&#146;s starting time. </span></div>
<div class=styleNavBarBot>
<table width="836" border="0" cellspacing="2">
  <tr></tr>
  <tr>
    <td width="118"><a href="http://www.purepage.com"><img src="./smalllogo.gif" width="118" height="46" border="0" alt="http://www.purepage.com"></a></td>
    <td></td>
  </tr>
</table>
</div>

</td></tr></table>

</body>
</html>
